home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / gcore.man < prev    next >
Encoding:
Text File  |  1989-02-06  |  2.9 KB  |  135 lines
  1.  
  2.  
  3.  
  4. <GCORE>                   User Commands                   <GCORE>
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      gcore - Generate a core file from a Sprite process.
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ggccoorree [_o_p_t_i_o_n_s] _p_i_d _p_i_d ...
  15.  
  16. OOPPTTIIOONNSS
  17.      --oo _p_r_e_f_i_x Generate the output file names by  prepending  the
  18.                string _p_r_e_f_i_x to each of the pids.
  19.  
  20.      --kk        Kill the process after the core dump is produced.
  21.  
  22.      --ss _s_i_g_n_a_l Use signal number _s_i_g_n_a_l to pause running process.
  23.  
  24. _________________________________________________________________
  25.  
  26.  
  27. DDEESSCCRRIIPPTTIIOONN
  28.      GGccoorree generates a snapshot of the current execution state of
  29.      a  Sprite  process.   For historical reasons, these snapshot
  30.      are referred to as core dumps or core files.  Core dumps can
  31.      be  used  by the ggddbb debugger to examine the process's state
  32.      as if the debugger was attached to the process.
  33.  
  34.      GGccoorree takes as arguments one or more process  ids  and  gen-
  35.      erates  core  dumps  for  each  process in the file core._p_i_d
  36.      where _p_i_d is the specified process id.  The --oo option allows
  37.      a  string  other  than  "core" to be used to generate output
  38.      file names.  If the --kk option is  specified,  the  processes
  39.      specified  will be sent a SIGKILL signal after the core dump
  40.      is finished.
  41.  
  42.      GGccoorree reads the register state and memory image of a process
  43.      by  using the Sprite debugger interface (PPrroocc__DDeebbuugg.) If the
  44.      process is not already in the DEBUG state (see the  ppss  com-
  45.      mand), ggccoorree will send the process a SIGTRAP signal to force
  46.      it into the DEBUG state. This operation  will  fail  if  the
  47.      user does not have permission to send signals to the process
  48.      or the process  has  blocked,  ignored,  or  has  a  handler
  49.      installed for the SIGTRAP signal.  The --ss option can be used
  50.      to inform  ggccoorree  to  use  a  signal  number  other  than  5
  51.      (SIGTRAP).   Other  signals  that may work are 4 (SIGILL), 8
  52.      (SIGFPE) and 11 (SIGSEGV).  GGccoorree restarts  running  process
  53.      by sending them a SIGCONT after the dump is produced.
  54.  
  55. WWAARRNNIINNGG
  56.      The signals used by ggccoorree  to  stop  running  processes  can
  57.      interrupt system calls such as rreeaadd,, sseelleecctt, or sslleeeepp, caus-
  58.      ing them to return an error status of EINTR.  Some  programs
  59.      may interpret the EINTR as an error and exit.
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Sprite v.1.0       Printed:  February 5, 1989                   1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. <GCORE>                   User Commands                   <GCORE>
  73.  
  74.  
  75.  
  76. KKEEYYWWOORRDDSS
  77.      gdb, coredump
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  February 5, 1989                   2
  132.  
  133.  
  134.  
  135.